W09-2. ConfigMap · Secret · PV/PVC - 실습 가이드

9주차 실습: 방명록 + PostgreSQL 을 Kubernetes 로 이전

실습 목표 (45분)

  • Secret 을 만들고, 값이 base64 로만 저장된다는 것을 직접 확인한다.
  • PVC 를 쓰는 PostgreSQL 을 띄우고, PVC 가 Pending → Bound 되는 과정을 본다.
  • ConfigMap + Secret 으로 방명록을 DB 에 연결하고, Pod 3개가 같은 글을 보여 주는 것을 확인한다.
  • Pod 를 다 지워도 데이터가 남는 것, ConfigMap 을 바꾸면 재시작해야 반영되는 것을 확인한다.

시작 전 확인

  • Kubernetes running, 컨텍스트 docker-desktop
  • 작업 폴더: macOS cd ~/docker-study/k8s / Windows cd "$HOME\docker-study\k8s"
  • 8주차에 만든 것이 남아 있어야 합니다. 확인:
    kubectl get deployment,service,gateway,httproute
    
    deployment.apps/guestbook, service/guestbook, gateway.../study-gateway, httproute.../guestbook 이 보이면 OK.
    • 없다면 8주차 실습의 실습 1, 4, 5 를 먼저 하세요(Envoy Gateway 설치 포함, 약 15분).

실습 내용 시간
1 Secret 만들기와 들여다보기 6분
2 PostgreSQL + PVC 9분
3 ConfigMap 만들기 3분
4 방명록을 DB 에 연결 10분
5 다 지워도 데이터는 남는다 6분
6 ConfigMap 바꾸기 6분
7 정리 2분

실습 1. Secret 만들기와 들여다보기

1-1. 명령으로 만들기

비밀번호가 파일에 남지 않도록 명령으로 만듭니다.

kubectl create secret generic postgres-secret --from-literal=POSTGRES_PASSWORD=guestpw
kubectl get secret postgres-secret

출력 예시:

secret/postgres-secret created
NAME              TYPE     DATA   AGE
postgres-secret   Opaque   1      0s

DATA 1 은 키가 1개(POSTGRES_PASSWORD) 들어 있다는 뜻입니다. kubectl get 으로는 값이 보이지 않습니다.

1-2. 정말 안전할까? 값 꺼내 보기

kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}'

출력: Z3Vlc3Rwdw==

이것을 되돌려 봅니다.

macOS:

kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}' | base64 --decode

Windows (PowerShell):

$enc = kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}'
[Text.Encoding]::UTF8.GetStringFromBase64String($enc)

출력: guestpw

누구나 되돌릴 수 있습니다

Secret 의 값은 base64 로 인코딩되어 있을 뿐 암호화가 아닙니다. Secret 을 읽을 권한이 있으면 비밀번호를 그대로 알 수 있습니다.
그래서 Secret YAML 을 Git 에 올리지 않고, 읽을 수 있는 사람을 권한(RBAC) 으로 제한합니다(강의 노트 4장).


실습 2. PostgreSQL + PVC

2-1. postgres.yaml

VS Code 로 k8s 폴더에 postgres.yaml 을 만듭니다. PVC + Deployment + Service 세 개가 --- 로 나뉘어 들어 있습니다.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: postgres-data
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: postgres
spec:
  replicas: 1
  strategy:
    type: Recreate
  selector:
    matchLabels:
      app: postgres
  template:
    metadata:
      labels:
        app: postgres
    spec:
      containers:
        - name: postgres
          image: postgres:18-alpine
          env:
            - name: POSTGRES_USER
              value: guest
            - name: POSTGRES_DB
              value: guestbook
            - name: POSTGRES_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: postgres-secret
                  key: POSTGRES_PASSWORD
          ports:
            - containerPort: 5432
          volumeMounts:
            - name: data
              mountPath: /var/lib/postgresql
          readinessProbe:
            exec:
              command: ["pg_isready", "-h", "localhost", "-U", "guest", "-d", "guestbook"]
            periodSeconds: 5
      volumes:
        - name: data
          persistentVolumeClaim:
            claimName: postgres-data
---
apiVersion: v1
kind: Service
metadata:
  name: postgres
spec:
  selector:
    app: postgres
  ports:
    - port: 5432
      targetPort: 5432
부분 의미
PersistentVolumeClaim storage: 1Gi "1GB 저장소가 필요해요" 라는 요청서
strategy: type: Recreate 업데이트할 때 옛 DB Pod 를 먼저 끄고 새 Pod 를 켬 (DB 는 동시에 2개 뜨면 위험)
secretKeyRef 실습 1 의 Secret 에서 비밀번호를 가져옴
mountPath: /var/lib/postgresql PostgreSQL 18 의 데이터 폴더 (3주차와 같은 경로)
readinessProbe pg_isready 가 성공해야 준비 완료로 보고 Service 에 넣음
Service: postgres 방명록이 postgres:5432 라는 이름으로 접속할 주소

2-2. 적용하고 PVC 지켜보기

kubectl apply -f postgres.yaml
kubectl get pvc

출력 예시: 처음에는 Pending 입니다.

persistentvolumeclaim/postgres-data created
deployment.apps/postgres created
service/postgres created
NAME            STATUS    VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
postgres-data   Pending                                      standard       <unset>                 0s

DB 가 준비될 때까지 기다린 뒤 다시 봅니다.

kubectl rollout status deployment/postgres
kubectl get pvc
kubectl get pv

출력 예시:

deployment "postgres" successfully rolled out
NAME            STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
postgres-data   Bound    pvc-4f9cfa8c-7669-457a-a771-b965de01e6c8   1Gi        RWO            standard       <unset>                 15s
NAME                                       CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM                   STORAGECLASS   VOLUMEATTRIBUTESCLASS   REASON   AGE
pvc-4f9cfa8c-7669-457a-a771-b965de01e6c8   1Gi        RWO            Delete           Bound    default/postgres-data   standard       <unset>                          13s
무슨 일이 있었나

  1. PVC(요청서)만 있을 때는 Pending
  2. PVC 를 쓰는 PostgreSQL Pod 가 생기자 StorageClass standard 가 PV 를 자동으로 만들고 연결 → Bound
  3. PV 이름 pvc-… 는 자동으로 붙은 이름입니다. 우리는 PV 를 직접 만들지 않았습니다.

kubectl get storageclass

출력 예시:

NAME                 PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
hostpath             rancher.io/local-path   Delete          WaitForFirstConsumer   false                  97m
standard (default)   rancher.io/local-path   Delete          WaitForFirstConsumer   false                  97m

standard (default): PVC 에 StorageClass 를 안 적으면 이것을 씁니다. WaitForFirstConsumer 가 "Pod 가 생길 때 만든다" 는 뜻입니다.


실습 3. ConfigMap 만들기

configmap.yaml

apiVersion: v1
kind: ConfigMap
metadata:
  name: guestbook-config
data:
  APP_VERSION: "v2-k8s"
  DB_HOST: "postgres"
  DB_NAME: "guestbook"
  DB_USER: "guest"
kubectl apply -f configmap.yaml
kubectl get configmap guestbook-config -o yaml

ConfigMap 은 Secret 과 달리 값이 그대로 보입니다. 비밀이 아닌 설정만 넣습니다.
APP_VERSION 을 넣은 이유: 이미지 안의 기본값(v2)을 이미지를 다시 만들지 않고 바꿀 수 있는지 확인하려는 것입니다.


실습 4. 방명록을 DB 에 연결

4-1. deployment.yaml 고치기

deployment.yaml 을 아래처럼 바꿉니다. 바뀐 곳은 두 군데입니다: change-cause 문구, 그리고 ports: 아래에 envFrom: 과 env: 추가. 내아이디 는 그대로 본인 아이디입니다.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: guestbook
  labels:
    app: guestbook
  annotations:
    kubernetes.io/change-cause: "v2 + PostgreSQL 연결"
spec:
  replicas: 3
  selector:
    matchLabels:
      app: guestbook
  template:
    metadata:
      labels:
        app: guestbook
    spec:
      containers:
        - name: web
          image: 내아이디/guestbook:v2
          ports:
            - containerPort: 8000
          envFrom:
            - configMapRef:
                name: guestbook-config
          env:
            - name: DB_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: postgres-secret
                  key: POSTGRES_PASSWORD
            - name: DATABASE_URL
              value: "postgresql://$(DB_USER):$(DB_PASSWORD)@$(DB_HOST):5432/$(DB_NAME)"
들여쓰기 주의

envFrom: 과 env: 는 ports: 와 같은 칸(image: 와 같은 칸)에 있어야 합니다.

4-2. 적용

kubectl apply -f deployment.yaml
kubectl rollout status deployment/guestbook

4-3. Pod 안의 환경 변수 확인

kubectl exec deploy/guestbook -- env

deploy/guestbook 이라고 쓰면 Deployment 의 Pod 중 하나를 골라 실행합니다. Pod 이름을 찾을 필요가 없습니다.

출력 예시 (일부):

APP_VERSION=v2-k8s
DATABASE_URL=postgresql://guest:guestpw@postgres:5432/guestbook
DB_HOST=postgres
DB_NAME=guestbook
DB_PASSWORD=guestpw
DB_USER=guest
...

4-4. 브라우저 확인

http://guestbook.localhost 를 엽니다.

글을 2~3개 남기고, 새로고침을 여러 번 해 보세요. HOSTNAME(Pod 이름)이 바뀌어도 글 목록은 항상 같습니다.

관찰 예시 (실제로 확인한 결과): 응답한 Pod 끝 5글자 : 보이는 글 개수

fz6d2:1  pfvdl:1  s9t6k:1  pfvdl:1  s9t6k:1  s9t6k:1  s9t6k:1  fz6d2:1  s9t6k:1
8주차 실습 7 의 문제가 해결됐습니다 🎉

Pod 3개가 모두 같은 PostgreSQL 을 보기 때문입니다. 웹(앱)은 상태가 없게(Stateless) 만들고, 상태(데이터)는 DB 에 두는 것이 늘리고 줄이기 쉬운 구조의 기본입니다.

4-5. DB 에서 직접 확인

kubectl exec deploy/postgres -- psql -U guest -d guestbook -c "SELECT id, name, body FROM messages;"

출력 예시:

 id |  name   |     body
----+---------+--------------
  1 | Soojong | moved to k8s
(1 row)

실습 5. 다 지워도 데이터는 남는다

5-1. 방명록 Pod 전부 삭제

kubectl delete pods -l app=guestbook
kubectl rollout status deployment/guestbook

→ 새 Pod 3개가 생기고, 브라우저를 새로고침하면 글이 그대로 있습니다. (방명록 Pod 에는 원래 데이터가 없으니 당연합니다.)

5-2. DB Pod 삭제

이번에는 DB 를 지웁니다.

kubectl delete pod -l app=postgres
kubectl rollout status deployment/postgres
kubectl get pods -l app=postgres

출력 예시: 새 이름의 PostgreSQL Pod 가 Running 입니다.

pod "postgres-57c84bcc6-rrm7j" deleted from default namespace
deployment "postgres" successfully rolled out
NAME                       READY   STATUS    RESTARTS   AGE
postgres-57c84bcc6-b4wx4   1/1     Running   0          12s
kubectl exec deploy/postgres -- psql -U guest -d guestbook -c "SELECT count(*) FROM messages;"

→ 남긴 글 개수가 그대로입니다. 브라우저에서도 글이 그대로 보입니다.

새 DB Pod 가 같은 PVC 를 연결했기 때문입니다

kubectl describe pvc postgres-data

Used By: 에 새 Pod 이름이 보입니다. Pod 는 바뀌어도 데이터(PV)는 그대로입니다. 3주차 "컨테이너는 버려도 데이터는 볼륨에" 의 Kubernetes 버전입니다.

DB 가 다시 뜨는 몇 초 동안은?

그사이 방명록 페이지를 열면 Internal Server Error 가 날 수 있습니다. DB 가 1개뿐이라 생기는 짧은 중단입니다. 실무에서 DB 이중화나 관리형 DB 를 쓰는 이유입니다.


실습 6. ConfigMap 바꾸기

configmap.yaml 의 APP_VERSION: "v2-k8s" 를 APP_VERSION: "v2-k8s-config2" 로 바꾸고 저장합니다.

kubectl apply -f configmap.yaml

http://guestbook.localhost 를 새로고침하면 → 머리글은 아직 v2-k8s 입니다.

왜 안 바뀌었을까요?

환경 변수는 Pod 가 시작될 때 한 번만 읽기 때문입니다. 이미 떠 있는 Pod 는 예전 값을 그대로 갖고 있습니다.

Pod 를 새로 띄웁니다(이미지는 그대로, Pod 만 교체).

kubectl rollout restart deployment/guestbook
kubectl rollout status deployment/guestbook

새로고침 → 머리글이 v2-k8s-config2 로 바뀌었습니다. 글은 그대로입니다.

이미지를 다시 빌드하지 않고 설정만 바꿨습니다

같은 이미지를 개발·운영에서 다른 ConfigMap 으로 띄우는 것이 바로 이 방식입니다.


실습 7. 정리

10주차에도 모두 그대로 씁니다. 지우지 마세요.

kubectl get deployment,service,configmap,secret,pvc

출력 예시 (일부):

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/guestbook   3/3     3            3           17m
deployment.apps/postgres    1/1     1            1           67s

NAME                 TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
service/guestbook    ClusterIP   10.96.134.220   <none>        80/TCP     13m
service/kubernetes   ClusterIP   10.96.0.1       <none>        443/TCP    102m
service/postgres     ClusterIP   10.96.242.135   <none>        5432/TCP   67s

NAME                         DATA   AGE
configmap/guestbook-config   4      55s
configmap/kube-root-ca.crt   1      102m

NAME                     TYPE     DATA   AGE
secret/postgres-secret   Opaque   1      68s

NAME                                  STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
persistentvolumeclaim/postgres-data   Bound    pvc-19bd6110-57f1-4ad8-bda6-e3bc469056b2   1Gi        RWO            standard       <unset>                 67s
PVC 를 지우면 데이터도 사라집니다

StorageClass 의 RECLAIMPOLICY 가 Delete 라서, PVC 를 지우면 PV 와 데이터가 함께 삭제됩니다. 5주차 docker compose down -v 와 같습니다.


자주 나는 문제와 해결

증상 원인 해결
PostgreSQL Pod 가 CreateContainerConfigError Secret 이 없거나 이름·키가 틀림 kubectl get secret postgres-secret, 키 이름 POSTGRES_PASSWORD 확인
PVC 가 계속 Pending 이 PVC 를 쓰는 Pod 가 아직 없음 (정상), 또는 claimName 오타 PostgreSQL Pod 상태 확인, claimName: postgres-data 확인
PostgreSQL Pod READY 0/1 이 오래감 초기화 중 (readinessProbe 대기) kubectl logs deploy/postgres 로 ready to accept connections 확인
방명록 Internal Server Error DB 연결 실패 (DB 재시작 중, 비밀번호·주소 오류) kubectl logs deploy/guestbook, kubectl exec deploy/guestbook -- env 로 DATABASE_URL 확인
password authentication failed for user "guest" (방명록 로그) Secret 비밀번호를 바꿨는데 예전 PVC 의 DB 를 그대로 씀 비밀번호는 DB 를 처음 만들 때만 적용. 실습이면 PostgreSQL Deployment 와 PVC 를 지우고 다시
DATABASE_URL 에 $(DB_USER) 가 글자 그대로 남음 ConfigMap 이 없거나, envFrom 이 env 보다 아래/잘못된 위치 실습 3 적용 확인, 4-1 의 들여쓰기 확인
ConfigMap 을 바꿨는데 반영 안 됨 환경 변수는 시작할 때만 읽음 kubectl rollout restart deployment/guestbook
error: unable to upgrade connection: container not found (exec) 종료 중인 Pod 를 고름 잠시 뒤 다시, 또는 deploy/이름 형식 사용

오늘 쓴 명령어 정리

명령어 하는 일
kubectl create secret generic 이름 --from-literal=키=값 Secret 만들기
kubectl get secret 이름 -o jsonpath='{.data.키}' Secret 값(base64) 보기
base64 --decode (macOS) / [Convert]::FromBase64String() (Windows) base64 되돌리기
kubectl get pvc / kubectl get pv / kubectl get storageclass 저장소 확인
kubectl describe pvc 이름 PVC 상세 (Used By)
kubectl get configmap 이름 -o yaml ConfigMap 내용
kubectl exec deploy/이름 -- 명령 Deployment 의 Pod 하나에서 실행
kubectl rollout restart deployment/이름 이미지 그대로 Pod 만 새로 교체

복습 과제

확인 퀴즈

  1. 설정을 이미지 안에 넣지 않고 ConfigMap / Secret 으로 분리하는 이유는?
  2. Secret 이 "암호화가 아니다" 라는 말의 뜻과, 그래서 지켜야 할 것은?
  3. PVC, PV, StorageClass 는 각각 무엇인가요?
  4. PVC 가 처음에 Pending 이었다가 Bound 가 된 이유는?
  5. PostgreSQL Deployment 에 replicas: 1 과 strategy: Recreate 를 쓴 이유는?
  6. ConfigMap 의 APP_VERSION 을 바꾸고 apply 했는데 화면이 그대로였습니다. 이유와 해결 방법은?
  7. 방명록 Pod 3개가 모두 같은 글을 보여 주게 된 이유는?

도전 과제 (선택)

  1. ConfigMap 을 파일로 넣어 보세요. 아래를 deployment.yaml 의 Pod spec 에 추가하고(containers: 와 같은 칸에 volumes:, web 컨테이너 안 ports: 와 같은 칸에 volumeMounts:), kubectl exec deploy/guestbook -- ls /config 로 확인해 보세요. ConfigMap 의 키가 파일 이름이 됩니다.
              volumeMounts:
                - name: config
                  mountPath: /config
          volumes:
            - name: config
              configMap:
                name: guestbook-config
    
  2. kubectl get pv 의 PV 를 kubectl describe pv <이름> 으로 보세요. Node Affinity 항목에 특정 노드 이름이 있습니다. 왜 그럴까요? (힌트: local-path 는 노드의 디스크에 저장합니다. 그래서 DB Pod 는 그 노드에서만 다시 뜰 수 있습니다. 클라우드 블록 스토리지는 이런 제약을 다르게 처리합니다.)
다음 주 예고: 10주차 실무 맛보기

마지막 주에는 운영에 필요한 것들을 맛봅니다. 헬스체크(Probe) 로 고장 난 Pod 를 자동으로 빼고, 리소스 제한과 오토스케일링(HPA) 으로 부하에 따라 Pod 수를 늘리고, Gateway API 로 카나리 배포를 하고, 클라우드의 관리형 Kubernetes(PaaS) 와 비교합니다.


네비게이션

이전 목록 다음
◀ 9주차 강의 노트 목록으로 10주차 강의 노트 ▶